Skip to content

docs: prepare the docs and the release steps for 2.0.0-beta.2 - #22

Merged
diecodev merged 3 commits into
v2from
docs/prepare-beta-2
Oct 30, 2026
Merged

diecodev merged 3 commits into
v2from
docs/prepare-beta-2

Conversation

@diecodev

Copy link
Copy Markdown
Owner

Brings the docs in line with what 2.0.0-beta.2 ships (#16) and switches the release docs to pnpm stage.

Merge this right before pnpm release. It touches website/, so merging deploys the site, and the docs would describe beta.2 while beta.1 is still the published version.

Docs (website/)

  • Known issues: the beta.1 entries are gone, now that they're fixed:

    • a Toaster or useSonner() first rendered on the client;
    • topLayer with modals or several Toasters;
    • the theme="system" listener;
    • the missing type unions.

    The one issue left is documented: on the dev server only, two toasts fired back to back can stall the Toaster.

  • Introduction: removed the "keep the Toaster in a server-rendered layout" warning.

  • Advanced:

    • "How it works" and useSonner() explain when they subscribe and unsubscribe.
    • The top-layer list covers several Toasters and modals opened while toasts are showing.
    • The TypeScript section imports the newly exported types.
  • Styling: classes.default applies only to toasts without a type.

  • Options: important and Action.actionButtonStyle are marked deprecated.

  • toast(): getHistory() keeps up to 100 toasts.

  • Migration: sonner 2.0.7 → 2.0.8.

  • Demos: the dialog demo no longer closes the top-layer popover before opening the modal, the counter loses its reload hint, and the site imports Position and Theme from qwik-sonner.

Release docs

CONTRIBUTING.md, AGENTS.md and a comment in release.yml say to approve with pnpm stage list / pnpm stage approve. npm stage still works.

Checks

  • fmt.check passes, and build.types, lint and the full SSG build pass in website/.
  • On the built site, in chromium and webkit:
    • The dialog demo shows the topLayer toast above the modal, including when the secondary Toaster already had a toast showing before the modal opened.
    • After a <Link> navigation to Examples, the counter updates.

The beta.1 known issues are gone: a Toaster or useSonner() first rendered on the client subscribes (and unsubscribes on unmount), topLayer works with several Toasters and comes back above modals, the theme listener follows the prop, and the type unions are exported. Also: classes.default only applies to toasts without a type, toast.getHistory() keeps up to 100 toasts, important and Action.actionButtonStyle are marked deprecated, and the behaviour now matches sonner 2.0.8. The one issue left is the dev-server stall with two toasts back to back.
The dialog demo no longer closes the top-layer popover before opening the modal, the counter demo loses its reload hint, and the site imports Position and Theme from qwik-sonner instead of deriving them.
@vercel

vercel Bot commented Oct 30, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
qwik-sonner Ready Ready Preview Oct 30, 2026 2:13am UTC

@diecodev
diecodev merged commit 2f82be8 into v2 Oct 30, 2026
5 checks passed
@diecodev
diecodev deleted the docs/prepare-beta-2 branch October 30, 2026 02:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant